home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 19 / Night Owl (The Best of Shareware)(NOPV 19)(1996).ISO / 007a / ftoss102.zip / FILETOSS.DOC < prev    next >
Text File  |  1995-09-05  |  9KB  |  273 lines
  1. FileToss - The Simple TIC processor for points
  2. v1.02 Official Release
  3.  
  4.                           Copyright (C) 1995
  5.                             Lawrence Gordon
  6.                           All Rights Reserved
  7.  
  8. I.      What is FileToss?
  9.  
  10. FileToss is a simple TIC-processing system, designed especially for 
  11. points.  FileToss is not a "full-featured" TIC processor.  It lacks 
  12. both "hatching" and file forwarding ability. It merely moves files from 
  13. your mailer's inbound file directory to whatever target directories you 
  14. specify. It is fast, small, and very easy to set up and use.
  15.  
  16. II.     How does FileToss work?
  17.  
  18. FileToss can run "stand-alone" or can be called from a batch file.
  19. Quite simply, all you have to do is type "FileToss". It takes no
  20. arguments.  There are two configuration files you have to set up 
  21. first, FILETOSS.CFG and FILETOSS.BBS.  They must exist in the same 
  22. directory as the directory from which FileToss.exe is called, 
  23. otherwise FileToss won't do very much,.  A simple batch file to
  24. use FileToss might look like this:
  25.  
  26. @echo off
  27. bnu /l:1=38400,8N1 /F
  28.  
  29. :loop
  30. c:
  31. cd\fd
  32. fd /nounpack
  33. if errorlevel 250 goto mail_in
  34. if errorlevel 245 goto read_mail
  35. if errorlevel 240 goto mail_out
  36. if errorlevel 10 goto user_break
  37. if errorlevel 0 goto stop_bat
  38.  
  39. :mail_in
  40. c:
  41. cd\fd
  42. fmail toss
  43. if exist c:\fd\file\*.tic goto tic_in
  44. goto loop
  45.  
  46. :read_mail
  47. c:
  48. cd\fd
  49. call editor.bat
  50. goto loop
  51.  
  52. :mail_out
  53. c:
  54. cd\fd
  55. fmail scan
  56. goto loop
  57.  
  58. :tic_in
  59. c:
  60. cd\fd
  61. filetoss
  62. goto loop
  63.  
  64. :user_break
  65. goto stop_bat
  66.  
  67. :stop_bat
  68. bnu /u
  69. exit
  70.  
  71. This batch file assumes that FileToss.exe is in your C:\FD directory
  72. and that the configuration files, FILETOSS.CFG and FILETOSS.BBS are
  73. there, too.  In fact, FileToss won't run unless they are in the same
  74. directory.
  75.  
  76. III.    Configuring FileToss - Part 1 - FILETOSS.CFG
  77.  
  78. FILETOSS.CFG is a simple text file that tells FileToss about your
  79. system. The format of FILETOSS.CFG is simply
  80.  
  81. STATEMENT=VARIABLE
  82.  
  83. A sample FILETOSS.CFG file is included. Edit it to reflect your setup.  
  84. The sample .cfg file is included here in its entirety and all the 
  85. Statements and Variables are explained. 
  86.  
  87. ;--------------------------------------------------------------------------
  88. ;                       FILETOSS.CFG Configuration File
  89. ;--------------------------------------------------------------------------
  90. ;This is the FILETOSS.CFG configuration file. It contains the information
  91. ;about your inbound directory and log file.
  92. ;
  93. ;Make the appropriate changes to this file.
  94. ;
  95. ;Format rules for FILETOSS.CFG:
  96. ;
  97. ;All statements must begin in Column 1
  98. ;All comments must begin with ";"
  99. ;
  100. ;The correct format is STATEMENT=VARIABLE
  101. ;The STATEMENT must be capitalized!!!!!!!
  102. ;All STATEMENTs must have an "=" sign variable
  103. ;Leave no blank spaces after the "=" sign
  104. ;
  105. ;STATEMENTs used by FileToss are INBOUND, REPORT and SCANLIST
  106. ;
  107. ;Neither INBOUND nor REPORT may reside in the root directory of any drive.
  108. ;
  109. ;--------------------------------------------------------------------------
  110. ;INBOUND is the directory in which your .TIC files can be found.
  111. ;Do not use a trailing backslash in your directory name.
  112. ;This field is required.
  113. ;
  114. INBOUND=C:\FD\FILE
  115. ;
  116. ;--------------------------------------------------------------------------
  117. ;REPORT is the FileToss Log file. You can specify a name and
  118. ;directory for your log file.
  119. ;
  120. REPORT=C:\FILETOSS\FILETOSS.LOG
  121. ;--------------------------------------------------------------------------
  122. ;SCANLIST is a text file listing the target directory and names of all
  123. ;files processed by FileToss.  It can be used with a virus scanner or
  124. ;rearchiving program after FileToss has processed your incoming files.
  125. ;
  126. SCANLIST=C:\FILETOSS\SCANLIST.TXT
  127. ;--------------------------------------------------------------------------
  128. ;That's all folks!
  129.  
  130.  
  131. IV.     Configuring FileToss - Part 2 - FILETOSS.BBS
  132.  
  133. FILETOSS.BBS is a simple text file, but it _must be set up correctly_.  
  134. A sample FILETOSS.BBS file is included. Edit it to reflect your setup.
  135. The sample .bbs file is included here in its entirety.
  136.  
  137. ;--------------------------------------------------------------------------
  138. ;                       FILETOSS.BBS Configuration File
  139. ;--------------------------------------------------------------------------
  140. ;This is the FILETOSS.BBS configuration file. It contains the information
  141. ;about your TIC Areas, and target directories.
  142. ;
  143. ;Make the appropriate changes to this file.
  144. ;
  145. ;Format rules for FILETOSS.BBS:
  146. ;
  147. ;All statements must begin in Column 1
  148. ;All comments must begin with ";"
  149. ;Each line must contain 2 and only 2 arguments:
  150. ;
  151. ;Argument 1: The TIC Area tag from the FDN. This may be more than 8 
  152. ;characters, but FILETOSS will truncate any TIC Area exceeding 8 character.
  153. ;
  154. ;Argument 2: The Target directory. This tells FILETOSS where to move 
  155. ;your incoming files. Directories must be terminated with the 
  156. ;backslash "\".
  157. ;
  158. ;The TARGET_DIRECTORY must not be the root directory of any drive.
  159. ;
  160. ;--------------------------------------------------------------------------
  161. ;
  162. ;TIC Area  Target Area Directory
  163. ;--------  ---------------------------
  164. NODEDIFF   C:\FD\NODELIST\
  165. TOADNET    C:\FD\NODELIST\
  166. FIDONEWS   C:\FIDONEWS\ 
  167. SOFTDIST   C:\SOFTDIST\
  168. ;--------------------------------------------------------------------------
  169. ;That's all folks!
  170.  
  171. Set up all your TIC file areas before running FileToss. If you
  172. omit a TIC area, FileToss will not move those files in that TIC area.
  173.  
  174. Are you still with me?
  175.  
  176. V.      Output files.
  177.  
  178. FileToss produces a number of output files.
  179.  
  180.   A.    FILETOSS.LOG
  181.  
  182.         A log file, called FileToss.log, is kept of all the TICs 
  183.         processed by FileToss.
  184.  
  185.   B.    FILETOSS.ERR
  186.  
  187.         A log file, called FileToss.err, is kept anytime FileToss
  188.         exits prematurely. It contains the date, time and
  189.         description of the condition causing the premature exit.
  190.         This will help you figure out where you are going wrong,
  191.         and help me figure out where I'm going wrong.
  192.         (It won't help you figure out where I am going wrong, though.)
  193.  
  194.   C.    XXXXXXXX.FTC
  195.  
  196.         FileToss saves all TIC files during processing with the
  197.         .FTC extension. If your program aborts for some reason,
  198.         your TIC files may be restored by renaming all *.FTC
  199.         files to *.TIC. Under normal operation, these files will
  200.         be erased.
  201.  
  202.   D.    FILES.BBS
  203.  
  204.         FileToss produces a standard FILES.BBS file in your
  205.         target directory for use with other file processing
  206.         programs.
  207.         
  208.   E.    SCANLIST.TXT
  209.   
  210.         FileToss produces a text file for later processing
  211.         by your virus scanner/rearchiving utility based on
  212.         the SCANLIST= statement in your FILETOSS.CFG file.
  213.  
  214. VI.     The Whole Shebang
  215.  
  216. This is the sequence of events:
  217.  
  218.   A.    User runs FileToss
  219.   B.    FileToss checks for TIC files.
  220.   C.    If it finds any, it reads them and moves the associated files
  221.         to the proper target directories.
  222.   D.    FileToss is done.
  223.  
  224. VII.    Operating Tips/Support
  225.  
  226. This program works for me. It may not work for you. In any event,
  227. all FileToss is guaranteed to do is take up space on your harddrive.
  228.  
  229. Users with problems may obtain support by following these rules:
  230.  
  231. 1. Report all problems to me via netmail at Fidonet 1:100/560.  
  232.    All reports should tell me the version number of FileToss, your 
  233.    directory information, your system configuration, and a copies 
  234.    of your FILETOSS.ERR, FILETOSS.CFG and FILETOSS.BBS files.
  235.    Please archive these files and name them something like
  236.    USER.ZIP where USER is your name.
  237.  
  238. 2. Read the FidoNet POINTS echo for messages and announcements
  239.    concerning FileToss. I monitor the POINTS echo and I am
  240.    available there to answer questions and to take your heat when
  241.    the program flops on you.
  242.  
  243. 3. Run FileToss stand-alone a few times before you set it up as
  244.    an event or call it from your batch file so you can see what
  245.    it is doing and report any problems with it to me.
  246.  
  247. VIII.   Registration
  248.  
  249. FileToss is freeware; no registration is required. Enjoy it.
  250.  
  251. IX.     Trademarks, Copyrights, etc.
  252.  
  253. FileToss is copyrighted by Lawrence Gordon.
  254.  
  255. Lawrence Gordon
  256. 4 Waverton
  257. St. Louis, MO  63124
  258. BBS Phone (314) 994-0312
  259. FidoNet 1:100/560
  260.  
  261. History:
  262.  
  263. 06/30/94    Version 1.0 released.
  264.  
  265. 03/07/95    Version 1.1 released. Added support for standard
  266.             FILES.BBS output file. Added support for a SCANLIST.TXT
  267.             for later processing by your virus scanner/rearchiver.
  268.             Replaced BIOS screen writes with direct screen writes. 
  269.             Corrected documentation.
  270.  
  271. 09/05/95    Version 1.2 released. Optimized source code and minor
  272.             improvements. Corrected FILETOSS.CFG documentation.
  273.